Make global GDK libgtk_only functions more private

The current way of exposing GDK API that should be considered internal
to GTK+ is to append a 'libgtk_only' suffix to the function name; this
is not really safe.

GLib has been using a slightly different approach: a private table of
function pointers, and a macro that allows accessing the desired symbol
inside that vtable.

We can copy the approach, and deprecate the 'libgtk_only' symbols in
lieu of outright removal.

https://bugzilla.gnome.org/show_bug.cgi?id=739781

inspector: Reserve space for buttons

Make the button area in the top left a stack that is parallel
to the main page stack. This avoids size changes as we switch
between pages.

extract-strings: Handle property binding attributes

These attributes are now used in at least one place in the
GtkInspector ui files.

inspector: Improve search on the statistics page

Use a search bar here as well, instead of the builtin treeview popup.

inspector: Move the record button up

Give all the page space to the content.

inspector: Shorten some labels

inspector: Improve search in the resource tree

Make search in the resource tree work the same way as the new
search in the object tree.

inspector: Correct a tooltip

gdkwindow-x11: Fix indentation

inspector: Remove unused variable

inspector: Look for themes in the right places

Match the places that GtkCssProvider looks in, so we show all
the themes that GTK+ would actually find.

wayland: Schedule a clock tick instead of wl_surface_commit()ting directly

Instead of possibly calling wl_surface_commit() out of
GdkFrameClock::after-paint, tick the transient parent clock so ::after-paint
can be eventually run.

This ensures that the subsurface coordinates (considered part of the state
of the parent) aren't committed untimely, and guaranteed to be orderly with
the wl_subsurface-relative state.

This is a gtk-side fix for https://bugzilla.gnome.org/show_bug.cgi?id=738887

wayland: Don't translate a NULL region into an empty one

cairo_region_copy(NULL) will effectively return an empty region, as this
function is always meant to return valid memory. This however inverts the
meaning of the NULL region and results in entirely non-clickable windows.

gtkwindow: claim the press sequence when clicking on the titlebar

This event might not have an action yet, but certainly accounts, and
should be triggering recognition.

This fixes a crash when attempting to drag CSD windows through touch. As
since cfaec2d2f542, gtk_gesture_single_get_current_sequence() would
rightfully return NULL if the gesture didn't enter recognition, making
event lookup fail.

treeview: remove single-click activation from GtkGestureMultiPress::pressed

This is already handled in GtkGestureMultiPress::release, and more in
concordance with how it was done pre-gestures.

https://bugzilla.gnome.org/show_bug.cgi?id=737891

Revert "Add new API to docs"

This reverts commit 41e9eaf64fdabf49679db193778b15c44e3d0b52.

inspector: include private gdk headers

...the advantages of living in the same tree.

Don't make the gl flags API

We need to export the symbols so they can be used in the
inspector, but we don't really want to make this supported
public API, so keep them out of installed headers.

Add new API to docs

inspector: Add GL flags

Export API to set GL flags

This will be used in the inspector.

Adwaita: scrollbar styling overhaul

  - finally added the missing border;
  - proper backdrop state styling;
  - tweaked overlay indicator;
  - sidebar special casing gone for now.

gdkgl: Make some helper functions static

mir: rework cursors a bit

Store the cursor name on the cursor (rather than always using its type).

Use this when setting a cursor on a surface.

The mir server will fallback to using standard cursors from the cursor
theme if the name used is not one of those defined by mir, which is more
or less what we want to happen here in case of creating a cursor by
name.

mir: enable csd

mir: set cursor

Drop an unneeded include

GtkModelButton: protect against show_all

We don't want the labels to be shown when there's already
an icon.

GdkWindow: Drop gl matrix setup which is not needed anymore.

gdk_gl_texture_from_surface: Enable scissor test

gdk_gl_texture_quad: Fix handling of window scales

Adwaita: remove last child border on backdrop column headers

Adwaita: initial overlay indicator styling

GdkX11GLContext: Use bitblit for swap if no buffer age support

If buffer age is undefined and the updated area is not the whole
window then we use bit-blits instead of swap-buffers to end the
frame.

This allows us to not repaint the entire window unnecessarily if
buffer_age is not supported, like e.g. with DRI2.

Add gdk_gl_context_has_framebuffer_blit()

This checks if the context supports GL_EXT_framebuffer_blit

GdkGL: Fix up GL_ARB_texture_rectangle support

This broke when gdk_gl_texture_quad moved to shaders. We need
a specialized shader for the rectangle case.

Add support for GDK_GL=texture-rectangles

This allows us to test our support for GL_ARB_texture_rectangle

Add GDK_GL env var and GdkGLFlags

This moves the GDK_ALWAYS_USE_GL env var to GDK_GL=always.
It also changes GDK_DEBUG=nogl to GDK_GL=disable, as GDK_DEBUG
is really only about debug loggin.

It also adds some completely new flags:

 software-draw-gl:
   Always use software fallback for drawing gl content to a cairo_t.
   This disables the fastpaths that exist for drawing directly to
   a window and instead reads back the pixels into a cairo image
   surface.

 software-draw-surface:
   Always use software fallback for drawing cairo surfaces onto a
   gl-using window.  This disables e.g. texture-from-pixmap on X11.

 software-draw:
   Enables both the above.

gdk_cairo_draw_from_gl: Remove useless call

The glFramebufferTexture2DEXT call makes no sense here, we're
not using the texture as a framebuffer, just as a normal
texture source.

GdkWindow: Try to use a Core 3.2 GL profile for the paint context

If this is supported we avoid a lot of legacy baggage which we don't
need.

gdk_gl_texture_quad: Use shaders to texture things

This is the modern way OpenGL works, and using it will let us
switch to a core context for the paint context, and work on
OpenGL ES 2.0.

GdkGL: Rename "context" to "paint_context" to clarify things a bit

gdk_cairo_draw_from_gl: Document that this changes the current context

GdkGLContextX11: Use passed in context, not get_current()

Add gdk_gl_texture_quad() helper

Right now this just centralizes the glBegin/glEnd code, but
this will be replaced with buffer objects later.

gdkgl: Don't constantly re-create the tmp framebuffer

Updated Greek translation

GtkHeaderBar: Queue a resize when pack-type is changed

Otherwise, buttons appear to stick to the wrong side in glade.

mir: Handle pointer up/down events without a button mask set (i.e. touch events)

The Mir backend was checking for button mask changes to generate the appropriate
GDK event. When Mir generates a touch event it has no button mask. In this case
we'll just generate a primary button event.

Adwaita: dim GtkPlacesSidebar icons color

tests: Add deprecation guards

It's the last test still spewing these and I'm too lazy to do a proper
fix.

widget-factory: Fill up page 2 properly

The collapsed expander leaves and odd empty corner, so expand
it initially.

widget-factory: Add another osd

This is modeled after the totem osd.

GdkGLContextX11: Only set swap interval when it changed

GdkGL: Fix and clean up gdk_cairo_draw_from_gl()

This was unnecessarily creating a framebuffer in the texture case,
and it was not properly setting up a framebuffer with the texture
as source in the software fallback w/ texture source case.

mir: Don't assert on unknown Mir events.

If we get a Mir event we don't understand generate a warning instead of an assert.

GtkHeaderBar: Make the position child property writable

Glade asssumes that it is, and without this, rearranging children
in glade is very cumbersome.

gtkwindow: Resort to regular event bubbling by all means on non-toplevels

If the multipress gesture is not created (ie. not a toplevel GtkWindow),
also avoid possibly calling gtk_widget_event() on the events gotten here.

gtkwindow: Do not create the multipress gesture for plugs

GtkPlugs may "qualify" as toplevels, even though they're not meant to
be WM manipulated, so refuse to create the multipress gesture for these
too.

Updated Hebrew properties translation

Updated Hebrew translation

Adwaita: brighter dark variant header-bar bottom shade

Make window scale changes work again

Commit afd9709afff151e04b84b91c6d90b7 made us keep impl window
cairo surfaces around across changes of window scale. But the
window scale setter forgot to update the size and scale of the
surface. The effect of this was that toggling the window scale
from 1 to 2 in the inspector was not causing the window to draw
at twice the size, although the X window was made twice as big,
and input was scaled too. Fix this by updating the surface when
the window scale changes.

Add some more builder tests

GtkGLArea: Correctly position/size input window on realize

GdkGLContext: Add display property

We need to use this in the code path where we make the context
non-current during destroy, because at that point the window
could be destroyed and gdk_window_get_display() would return
NULL.

GtkGLArea: Don't dispose gl context on unrealize

This was done to ensure the context is not current, but this is
pretty broken for shared contexts. We now just make it non-current.

GtkGLArea: Add create-context signal

This lets you hook into the GL context creation which is useful
if you want to share one GL context between GtkGLArea widgets.

Only warn once if inhibit-related dbus calls fail

No need to spam about it.

https://bugzilla.gnome.org/show_bug.cgi?id=734140

GtkIconTheme: Improve an error message

Mention the name of the theme when an icon lookup fails.
https://bugzilla.gnome.org/show_bug.cgi?id=687963

GtkFileChooser: Add a menuitem for 'sort directories first'

This has been requested repeatedly.

gtkmenu: fix unnecessary scroll buttons

Don't change menu height if menu is out of monitor only by shadow
width.

https://bugzilla.gnome.org/show_bug.cgi?id=738321

Adwaita: add borders to menus in a non composited env

https://bugzilla.gnome.org/show_bug.cgi?id=738800

GtkHeaderBar: Fix a corner-case in child properties

The child property setting must be prepared to deal with any
child property for any child, even if it doesn't make sense,
like the pack-type for the custom title. This is happening
in glade when undoing a change in the custom-title property.

Updated Greek translation

csd: Improve appearance inside glade

glade turns windows into non-toplevels, so we can easily recognize
that situation and avoid adding a humongous shadow area.

Fix an ordering issue in event destruction

gdk_event_get_display accesses event->any.window, so don't
free that window first thing.

GtkVolumeButton: Fix annoying double formatting

We meant to specify 0.2, and it came out as 0.2000000001.

glade: Add GtkColorEditor to private widgets

glade: Drop a no-longer existing private widget

GtkScaleButtonScale fell by the wayside when the scale button
was ported to a popover.

radiobutton: don't consider hidden buttons in the group for focus

When a GtkRadioButton has no focus, it will accept it when there is no
other active button in its group.
If the active button in the group is hidden, for example because the UI
desires not to have a default option pre-selected, currently the focus
will not be accepted, which is not desired behavior.

This commit changes the code to only consider visible buttons in the
group when checking whether another button is active.

https://bugzilla.gnome.org/show_bug.cgi?id=739474

GtkListBox: Fix a bug in unselection

Ensure that gtk_list_box_get_selected_row returns NULL after
gtk_list_box_unselect_all. Add a testcase that detects this
problem.

icon-browser: Add search

Most of the code was already in place, just some loose ends
to fix up.

inspector: Search refinements

Show close buttons on all search bars.

inspector: Refine object tree search

Behave similar to traditional treeview search, and center
the row when moving between matches.

inspector: Add search to the object tree

This is also an attempt to figure out a better story for search
in treeviews.

Trivial: sort file list alphabetically

Adwaita: special case .default-decoration

Titlebars which are just window handles can be smaller.

Adwaita: simpler gtkcalendar style (once again)

inspector: Improve search in style property list

Use a search bar with a search entry instead of the builtin
treeview search popup.

inspector: Improve search in property list

Use a search bar with a search entry instead of the builtin
treeview search popup.

inspector: Stop overeager activation

Stop using activate-on-single click for the property list -
it is a little annoying to have the popover come up when you
just click in the list to get the focus there.

GdkGLArea: fix has_alpha changes at runtime

We need to completely reallocate the buffers if we switch
has_alpha, because we may switch from render buffers to
texture.

GtkGLArea: Add resize signal

This is very useful, as almost all GL code wants to recalculate
the cameras each time the window size changes.

GtkGLArea: Add profile property

This lets you force a core 3.2 context if you want

GtkGLArea: Add INPUT_ONLY window so that we can get events

GtkGLArea: Major reworking

This restructures the way buffers are allocated and bound in a way
that is more flexible.

Buffer operation happens in three phases:
create_buffer() - Creates the gl objects
allocate_buffers() - Allocates space for the buffers at a given size
attach_buffers() - Attaches the buffers to the framebuffer and makes
                   the framebuffer the default drawing target
And destroy via
delete_buffers()

We call all these the first draw, and after that we allocate buffers
each time the widget changes size until the buffers are deleted.
We delete the buffers at unrealize.

However, anyone that wants to manually control buffer allocation strategies
can manually call allocate/delete_buffers().

There are also some other changes:
* Support for stencil buffers.
* A manual render mode where ::draw doesn't render unless you manually
  invalidated the previous rendering.

gdk_x11_display_make_gl_context_current: move some code

This moves the code related to the frame sync code into
the is_attached check, which means we don't have to ever
run this when making non-window-paint contexts current.

This is a minior speed thing, but the main advantage
is that it makes making a non-paint context current
threadsafe.

Adwaita: darken a bit OSD background color

To not make it vanish on dark variant background color.

Improve warning

Mention the file that we're failing to load. That makes it obvious
what is wrong.